---
title: "Create a new address for a customer"
method: POST
path: "/admin/customers/{customer_id:[0-9]+}/addresses.json"
tags: ["Customer Address"]
---

# Create a new address for a customer

`POST /admin/customers/{customer_id:[0-9]+}/addresses.json`

## Request

- Base URL: `https://shop-name.onshopbase.com`
- URL: `https://shop-name.onshopbase.com/admin/customers/{customer_id:[0-9]+}/addresses.json`
- Auth: API key in header `APP_ACCESS_TOKEN`
- TypeScript: <https://skmtc.dev/shopbase/apis/shopbase-internal-api/docs/admin/customers/:customer_id:[0-9]+/addresses.json/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new address for a customer.

## Request body

- CustomerAddressCreateForm
  - `address` CustomerAddressDetail
    - `address1` string: The customer's mailing address.
    - `address2` string: An additional field for the customer's mailing address.
    - `city` string: The customer's city, town, or village.
    - `company` string: The customer's company.
    - `country` string: The customer's country.
    - `country_code` string: The two-letter country code corresponding to the customer's country.
    - `country_id` integer: A unique identifier for the customer.
    - `country_name` string: The customer's normalized country name.
    - `cpf_number` string: Brazil CPF Number
    - `cpf_or_cnpj_number` string: CPF/CNPJ number
    - `created_at` string, date-time: Created at time
    - `default` boolean: Whether this address is the default address for the customer.
    - `first_name` string: The customer's first name.
    - `id` integer: A unique identifier for the address.
    - `last_name` string: The customer's last name.
    - `latitude` number: Latitude
    - `longitude` number: Longtitude
    - `name` string: Address name
    - `phone` string: Phone number Example 555-555-5555
    - `province` string: Province
    - `province_code` string: The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
    - `updated_at` string, date-time: Updated at time
    - `zip` string: ZIP

## Response `200`

OK

- CustomerAddressDetailResponse
  - `customer_address` CustomerAddressDetail
    - `address1` string: The customer's mailing address.
    - `address2` string: An additional field for the customer's mailing address.
    - `city` string: The customer's city, town, or village.
    - `company` string: The customer's company.
    - `country` string: The customer's country.
    - `country_code` string: The two-letter country code corresponding to the customer's country.
    - `country_id` integer: A unique identifier for the customer.
    - `country_name` string: The customer's normalized country name.
    - `cpf_number` string: Brazil CPF Number
    - `cpf_or_cnpj_number` string: CPF/CNPJ number
    - `created_at` string, date-time: Created at time
    - `default` boolean: Whether this address is the default address for the customer.
    - `first_name` string: The customer's first name.
    - `id` integer: A unique identifier for the address.
    - `last_name` string: The customer's last name.
    - `latitude` number: Latitude
    - `longitude` number: Longtitude
    - `name` string: Address name
    - `phone` string: Phone number Example 555-555-5555
    - `province` string: Province
    - `province_code` string: The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
    - `updated_at` string, date-time: Updated at time
    - `zip` string: ZIP

---

[API](https://skmtc.dev/shopbase/apis/shopbase-internal-api.md) - [All operations](https://skmtc.dev/shopbase/apis/shopbase-internal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shopbase/apis/shopbase-internal-api/revisions/353ccde6240d?raw)